!LockDir by Paul Vigay - Version 1.06 (30th Oct 2002)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Copyright Info
~~~~~~~~~~~~~~
The !LockDir application is SHAREWARE. This means that you are
free to use and copy this application subject to the following
conditions being met at all times:-
a) All program code and associated files remain the copyright
   of the author and they are not altered, reverse coded or
   edited in any way.
b) Should you find this application useful, you register yourself
   by sending UK 5.00 to the author at the address below. In
   return you will be eligable to receive free updates and news
   of other software releases.
c) Usage of this application is entirely at the users risk. The
   author will accept no responsibility for any corruption of
   data or loss of information arising from direct or indirect
   use of this application.
d) This application should NOT be distributed by Shareware or PD
   libraries without my express written permission.

Description
~~~~~~~~~~~
A small application to password protect directories from 
the RISC OS wimp environment. To use, simply alter your boot up
sequence to load !LockDir as part of your computer initialisation
sequence.

Instructions
~~~~~~~~~~~~
In order to protect directories, you need to load !LockDir's icon
onto the icon bar. This is determined by a system variable defined
in it's !Run file. Load !Run into a text editor such as !Edit or
!Zap and set the following line:-

           Set LockDir$Icon Yes         to install on the icon bar.
           
                   or
                   
           Set LockDir$Icon No       to NOT install on the icon bar.
           
The latter line should be used whenever you are not changing passwords.

When the icon is on the icon bar, simply drag the directory you wish
to password protect onto this icon. The directory will be checked to
see if it is already protected. If it is, you will be given the option
to change the password. If it is not, you will be prompted to enter a
new password.

Whenever a new password is entered, either press RETURN or click the
SELECT button on the prompt icon. You will then be asked to re-enter
the password for verification. Remember to make note of upper and lower
case letters when entering passwords. They DO make a difference.

To unprotect a directory, follow the instructions above and enter the
old password when prompted to 'Change password'. If the old password is
correctly entered, you will be prompted to enter a 'New password'. At
this point click on the prompt icon with the ADJUST button. The prompt 
will change to 'Delete password'. At this point, simply click SELECT 
to confirm the password removal for the specified directory.

N.B. Alt-Break can be disabled by removing the -altbreak parameter from
the last line in the !Run file. To re-enable altbreak, change the line
back to its default setting which is;

Run <LockDir$Path>.!RunImage -altbreak *%0


In Use
~~~~~~
When a password has been protected, attempting to double-click on it
will bleep and open an 'Access Denied' window. At this point you
have to enter the correct password in order to continue opening the
directory. If the correct password is entered, the directory filer
window will open in the usual way and you can continue. If you enter
the wrong password, you are given another try, up to a maximum of
three tries. If you get it wrong on the third try. You will be 
permanently locked out of the directory until you reset the computer.
Attempting to open the directory via '*Filer_OpenDir' will also be
detected. RISC OS 3.1 and above will also detect wildcarded directory
names being used.

I hope there are no bugs present in this application, but if you do
find any please let me know, together with the sequence of actions
you carried out immediately prior to the bug occurring.
           
Contacting the Author:
~~~~~~~~~~~~~~~~~~~~~~
!LockDir was written by Paul Vigay

You can contact me via post at:
	104 Manners Road,
	Southsea,
	Hants.,
	PO4 0BG
	England
	
or via Email: paul@vigay.com

Please enjoy.....



History...
~~~~~~~~~~
v1.00    First release version

v1.01    Minor bug fixes (can't remember now, as I only added this History
         section at v1.02

v1.02    (18th Apr 1996)
         Amended to allow applications to be run rather than opened, if 
         protected by !LockDir

v1.03    (11th Dec 1997)
         Amended to pick up on upper/lower case directory names.

v1.04    (23rd Feb 1999)
         Now disables Alt-Break

v1.05    (22nd Jun 1999)
         Re-wrote wimp polling routine to make much faster
         Made Alt-Break action switchable
         
v1.06    (30th Oct 2002)
         Re-compiled using 32-bit compiler

Things to do
~~~~~~~~~~~~
1.  Write module so that CLI commands are intercepted to stop people 
    bypassing !LockDir from the CLI prompt.
2.  Disable Alt-Break on RISC OS 3.5+
3.  Disable renames/deletes/moves etc (this will be in the module, coupled
    with 1.